CROMEMCO PROGRAM DEBUGGER 


CHAPTER 1: INTRODUCTION TO DEBUG 


The CROMEMCO DEBUG program nakes it possible 
to test and debug user programs. DEBUG is loaded 
into memory and moved to the highest memory 
available below CDOS. When using a 32K CDOS and 
DEBUG, there is 20K left for the user program. 


LOADING DEBUG 


DEBUG is loaded by typing one of the following 
commancs from CDOS. 


DEBUG 
DEBUG filename.ext 


where "filename" is the name of the program to be 
tested, and “ext" is the file extension. [In both 
cases, DEBUG is loaded into memory directly below 
CDOs. The CDOS jump instruction located at 
location 5H is changed to jump to the start of 
DEBUG. This allows locations 6H and 7H to still 
point to the lowest available memory location. 


The second command above is used to load the 
file to be tested into memory. If the extension 
("ext") is “.HEX", then the file is read as an 
INTEL HEX file. Any other extension is read as an 
absolute binary file, loaded at location 1H0H. 
Note that DEBUG does not load relocatable files. 
If an extension is ".REL" it will be loaded in as 
if it were binary and will not he executable. 
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CONTROL CHARACTERS 


Control characters are used in DEBUG and TRACE 


to help 


in entering commands. 


characters are the same as CDOS uses. 


These control 


Control-C (°C) go back to CDOS 
Control-H (7H) delete character and backspace on CRT 
Control-U (“7U) delete line 
Control-X (*X) delete character and echo 
underscore Gelete character and backspace on CRT 
RUBout (DEL) delete character and backspace on CRT 
During a printing (such as from the DM 
command) the following characters may be used. 
Control-S (7S) stop/start printing. if 
printing, this character will 
stop the printing. If already 
stopped, this character will 
resume the printing. 
break (or any other character) will 
abort the printing, prompt, and 


wait for the next command. 


COMMAND FORMAT 


DEBUG is controlled by one and two character 


commands from the terminal. 


forin with respect to spaces. 
Place of spaces. 


The format 


is free- 


Commas may be used in 


In the following, 


the examples 


@ll dump memory starting at location 1920@H and 


ending at location 1@FFH, 


DM12@08 18FF (CR) 
DM1868S188 (CR) 

DM 16086 16FF (CR) 
DM 1908 S 180 (CR) 
DMi000,10FF (CR) 
DM1988,S188 (CR) 
DM 1000 , 1OFF (CR) 
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@ REGISTER 


DEBUG was designed to give fiexibility in 
testing relocatable programs. The “@" register is 
used to tel] DEBUG where the module you wish to 
debug is located. This address car: be found from 
the map generated by the linking loader "LINK". To 
change the "@" register, type "@ (CR)" on the 
console, The computer will then type "@-xxxx " 
(where xxxx is the current value of the register). 
The computer will then wait for a new address. If 
a CR only is typed, the register remains unchanged. 
If an address and a CR is typed, then the register 
will contain the new address. The "@" register may 
now be used aS part of an address. The following 
example demonstrates its use. 


G/@ @A3 1028 


This is an example of the go command. 6reak 
points will be set at the beginning of the current 
modules, relative location A3H in the current 
module, and at location 1000H. This feature allows 
you to test a module without having to calculate 
absolute addresses. 


ADDRESS EXPRESSIONS 


For additional ease in specifying addresses an 
expression can be used. Within these expressions, 
addition, subtraction, the “@" register, and the 
"$" may be used. The "S$" is the current location 
of the program counter (P register). If many 
Modules are being tested, addition can be used to 
specify relative addresses. 


G/2321+A3 
The preceding example would set a break point 


at relative location A3H if the module is located 
at 2321H. 
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SWATH OPERATOR 


There are two ways to specify the address 
range of many commands. The first is to simply 
list the beginning. and end addresses (and where 
appropriate, the destination address). For 
example, the first command below programs the range 
@ through 13FFH into PROMS starting at location 
E488H. The Second command displays the contents of 
memory between addresses E48@H and E4@2H. 


PO 13FF E408 
DME40B8 E482 


Another way to do the same thing is to use the 
Swath operator, "S", to specify the width of the 
address range, rather than state the end address 
explicitly. 


PO $1490. £488 
DM E489S3 


ERRORS 


Any errors made during entering of a command 
may be corrected by typing Control-U (*U) to abort 
the line or by backspacing and correcting the line. 
If a CR has already been entered and DEBUG detects 
an error, the line will not be accepted and a "?" 
will be printed. Re-enter the line with the 
incorrect data corrected. 
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CHAPTER 2: DEBUG COMMANDS 


DEBUG and TRACE commands are described in 
detail below. The operator must wait for the 
prompt character ("-") before entering the command. 


A - Assemble into memory 


This command allows in-line assembly language 
to be assembled into memory. The command takes the 
following format. 


A beginning-addr (CR) 


The user is prompted with the absolute 
address, followed by the relative address. DEBUG 
reads from the console the assembler mnemonics and 
assembles the instruction into memory. The 
mnemonics for the various 2-88 instructions can be 
found in the 2-828 CPU TECHNICAL MANUAL published by 
Mostek and Zilog. If there was no error in the 
instruction, it is stored in memory and the user is 
‘prompted for the next instruction. The rules for 
address expressions apply to the addresses in the 
assembler mnemonics. In the following example the 
"@" register contains 1234H. 


A428 

1274 8846' ADD B 

1275 6841' CALL @93 
1278 6044' JP 1632+95 
127B 9847' . 


The A command terminates when the first blank line 
or a line starting with a "." is entered from the 
console. If there is an error in the input line, 
it will not be accepted, a "?" will be printed and 
the console will be prompted with the addresses 
again. 
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DM - DISPLAY MEMORY 


The contents of memory are displayed in 
hexadecimal form. Each line of the display is 
preceded by the address of the first byte and 
followed by the ASCII representation of the 
hexadecimal bytes. An example follows: 


DM100,538 

9160 48 41 42 43 44 45 46 47-48 49 4A 48 4C 4D 4E 4F @ABCDEFGHIJKLMNO 
B118 58 51 52 53 54 55 56 57-58 59 SA 38 31 32 33 34 PQRSTUVWXYZ81234 
©1280 35 36 37 38 39 G8 BB BB-08 OB BH AD BO BB AB BH S679... eee aanaes 


The formats of this command are as follows. 


DM (CR) 

DM beginnig-addr (CR) 

DM beginning-addr ending-addr (CR) 
DM beginning-addr S swath-width (CR) 
DM,ending-addr (CR) 

DM S swath-width (CR) 


The first format displays memory from the 
CURRENT display address, initially l180H, and 
continues for 8 lines. The second format displays 
from the beginning address and continues for 8 
lines. The third format displays from the 
beginning address -to the ending address. The 
fourth format displays from the beginning address 
for a length specified by the swath-width. The 
fifth format displays from the CURRENT display 
address to the ending address. The sixth format 
displays from the CURRENT display address for a 
length specified by the swath-width. 


If an "“X" is included after the “DM", the 
relative addresses are also printed, In the 
following example assume that the "@" register 
contains 10H. 


DMX100,S3a 

@188 O808' 46 41 42 43 44 45 46 47-48 49 4A 4B 4C 4D 4E 4F @ABCDEFGHISJKLMNO 
8118 9218" 58 51 52 53 54 55 56 57-58 59 SA 38 31 32 33 34 PORSTUVWXY201234 
8128 6928' 35 36 37 38 39 G8 BG BB-O0 O8 BA BB OG OB BO BB 56789... aeeee 
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DR - DISPLAY REGISTERS 


When DEBUG is re-entered from a break point, 
the user registers are saved. The registers may be 
displayed at any time by typing the following 
command. 


-DR (CR) 
SZHVNCE A=0@ BC=08008 DE=8000 HL=8800 S=0100 P=8180 8102" LD E,A 
SZHVNC A'=00 B'=0008 D'=86000 H'=08000 X=0000 Y=0000 I=00 


The letters “SZHVNC“ on the first row 
represent the flags, while on the second row they 
represent the prime flags. If the flag is on, it 
is printed, if the flag is off, a space is printed. 
If only the carry and zero flag are set then " Z C" 
would be printed. The flags are described below. 


Ss - Sign flag, S=l if the MSB of the result 
is one, i.e., the result is negative. 


z- Zero flag, Z=1l if the result of an 
operation is zero. 


H- Half-carry flag, H=1 if the add operation 
produced a carry into the 4th bit of the 
accumulator or a subtract operation 
Produced a borrow from the 4th bit of the 
accumulator. 


Vv- Parity or overflow flag. This flag is 
affectec by arithmetic and logical 
operations. If an overflow occurs during 
an arithmetic operation, the flag is set 
to one. After a logical operation, the 
flag is set to 1 if the result of the 
operation has even parity. 


N - Add/subtract flag, N#l if the last 
operation was a subtraction. 

Cc - Carry flag, C=1 if the operation produced 
a carry. 


The E flag on the first line is the state of 
the interrupt enabled flip-flop (IFF). If 
interrupts are enabled, the “"E" is printed, 
otherwise a space is printed. 
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The A register is printed next, followed by 
the BC, DE, and HL register pairs and the stack 
pointer. The program counter value is then printed 
in both absolute and relative. The opcode pointed 
to by the program counter is then displayed as an 
instruction. 


On the second line, the prime registers are 
displayed, F' (prime flags), A‘, BC’, DE', and HL‘. 
The IX, IY, and I (interrrupt page) registers are 
printed next. If the disassembled opcode includes 
an address, the relative value of this address is 
printed as the last thing on the line. 


-DR (CR) 
S H NCE A=00 BC=08800 DE=2000 HL=0800 S=8600 P=1234 @810' CALL 1334 
SZ NC A'=09 B'=0000 D'=80008 H'=0800 X=0000 Y=0008 1=00 (@118") 


E - EXAMINE INPUT PORT 


The data port is read and displayed as a 
hexadecimal number. The format of the command is: 


E data-port (CR) 


In the following example the data port 3 is 
read and displayed on the console. 


~E3 (CR) 
23 


EJ - EJECT DISK 


The format of the command follows. 
EJ d 


Where d is the disk number (A, B, C, D). I£ the 
designated disk is a CROMEMCO DUAL DISK SYSTEM 
model PFD, with the eject option, the diskette in 
the disk drive will eject. 


F = SPECIFY FILE NAME 
This command allows the operator to insert 
filenames in the two default FCBs (at 5CH and 6CH) 
and the command line into the default buffer (at 
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83H). The example below loads FILE1.COM into the 
first FCB and FILE2.COM into the second FCB. The 
complete line is also loaded into the default 
buffer. 


~FFILE].COM FILE2.COM OPTION] OPTION2 


This command can be used with the "R" command to 
read in disk files. 


G - GO 
The GO command has the following format. 
G(starting-addr)/(breakpoint-1) (breakpoint-2)...(breakpoint-5) 


Each of the addresses is optional. If the starting 
address is omitted, then the contents of the 
program counter is used. The registers are loaded 
from the user registers (these are the values 
displayed with the DR command). Execution begins 
with the starting address or the contents of the 
program counter. If break points were specified, 
an RST 30H is inserted at the break point addresses 
and a jump instruction is placed at location 36H. 
When a breakpoint is executed, control is returned 
to DEBUG, and all of the user registers are saved 
(the registers may then be displayed with the DR 
command). ALL breakpoints are then removed from 
the user program. The program counter is displayed 
after the breakpoint. Note the following about 
breakpoints: 


(a) Breakpoints can only be set in programs 
residing in RAM. This is because an RST 38H is 
inserted at each break point location. (The 
original contents of these locations are saved so 
that they can be restored after a break point is 
executed.) 


(b) Up to 5 break points can be set. If an 
attempt is made to enter more than 5 break points, 
the command will not be accepted. 


(c) When a break point is used, a jump 
instruction is stored at location 30H. Therefore 
locations 30H, 31H, and 32H are not available to a 
user program. 

The GO command has an additional feature that 
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is very helpful in debugging a program. A count is 
allowed for each break-point. This count is 
entered after the break-point and enclosed in 
parentheses. This count is the number of times the 
program reaches this address before control is 
returned to DEBUG. A count of one says to break 
the next time the address is reached. In the 
example below execution begins at location 10@H and 
will break when address 1099H is reached for the 
second time or when 123H is reached for the first 
time. 


-G108/169(2) 123 


Note that 123 and 123(1) means the same thing. 
Also note that the count is a hexadecimal number. 
Therefore 123(F) means to break after the address 
has been executed for the 15th time. 


H - HEXADECIMAL ARITHMETIC 


Hexadecimal addition and subtraction may be 
performed by this command. The first number to be 
printed is the sum of the two input numbers. The 
second number to be printed is the difference 
between the first number and the second number. In 
the example following, the first number is 1234 + 
321, and the second number is 1234 -321. 


-H1234,321 
1555 6Fi3 


L - LIST IN ASSEMBLER MNEMONICS 


The list command is used to list the contents 
of memory in assembly language mnemonics. The 
formats for this command are. 


L (CR) 

L starting-addr (CR) 

L starting-addr ending-addr (CR) 

L starting-addf S swath-width (CR) 
L,ending-addr (CR) 

L S swath-width (CR) 


The first format lists 16 lines of 
disassembled code starting from the current list 
address. The second format lists 16 lines from the 
starting address. The third format lists from the 
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Starting address to the ending address. The fourth 
format lists from the starting address for a length 
specified by the swath width. The fifth format 
lists from the current list address to the ending 
address. The sixth format lists from the current 
address for a length specified by the swath 
address. 


The first address of the disassembly is the 
absolute address. The sestond address is the 
relative address. If the disassembled instruction 
contains an address, the absolute address is 
printed in the instruction in hexadecimal and the 
relative address is printed to the right of the 
disassembled line. In the example that follows, 
the "@" register contains 2890H. 


-~L@529 812 

3082 @800' ADD B 

3001 @801' CALL 3262 (BAGB') 
3064 8804' CALL 3243 (@A43') 
3087 6807' CALL 3333 (@B33') 


300A @88A' LD A,B 

308B @829B' OR C 

380C @82C' IR Z,3800 (8808') 
300F @86F' INC HL 

3818 @818' INC DE 

3011 6811' INC BC 

3612 6812' LD A,H 


M - MOVE MEMORY 
The formats of this command follow. 


M source-addr source-end destination-addr 
M source-addr S swath-width destination-addr 


The first format moves the contents of memory 
beginning with the source address and ending with 
the source-end to the destination address. The 
second format uses the Swath width to determine the 
length of the move. 


The move is verified to insure that all bytes 
were moved correctly. If an overlapping move was 
made, errors will be reported. The error reporting 
can be terminated by typing any character. ; 


The move command can be used to fill a block 
of memory with a constant. In the following 
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example, a zero has been entered into location 106H 
using the SM command. The following command will 
move zeros from location 108H through 188H. 


-M198 S7 161 


Care should be taken not to move memory over DEBUG, 
TRACE or CDOS. 


O - OUTPUT TO DATA PORT 


This command outputs data to a data port. The 
following is the command format. 


O data-byte port-number (CR) 


P - PROGRAM PROMS 


This command allows programming of PROMs. The 
following are the command formats. 


P source-addr source-end destination-addr 
P source-addr S swath-width destination-addr 


The first format programs PROMs starting with the 
source address and ending with the source-end into 
PROMS beginning at the destination address. The 
second format-determines the length from the swath 
width. 


If the length of the source is not a multiple 
of 400H or if the destination does not begin at a 
408H boundary, DEBUG will reject the command. 
(Multiples of 49@H end in '806', '408', ‘'888', and 
"C@a"'.) 


Any number of 2788 or 2784 PROMS can be 
Programmed in the execution of one command as long 
as there are enough BYTESAVERS to contain them. 
Each PROM is verified with its source after all are 
programmed and any discrepancies are printed out. 
If no discrepancies are found, a prompt is printed 
and the next command may be entered. 


Software can be loaded into a PROM in as small 
increments as you desire, provided it is added to 
previously unused areas of the PROM. This is done 
by first using the Move command, "M", to transfer 
the contents of the PROM to RAM, adding the new 
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SM - SUBSTITUTE MEMORY 


This command is used to substitute memory. 
The format of the command follows. 


SM starting-addr 


DEBUG prints the absolute address, followed by the 
relative address, followed by the contents of the 
memory byte. One of the following may then be 


entered. 


(a) 


(b) 


(c) 


(dq) 


(e) 


(f£) 


data-byte value. The data byte value 
is stored at the address of the 
prompt. The address is then 
incremented by 1 and displayed on the 
next line. 


string enclosed in quotes. The string 
is stored beginning at the address of 
the prompt. The address is then 
incremented past the string and 
displayed on the next line. 


Any number of (a) and (b) above can be 
entered on one line. The address is 
then incremented past the bytes that 
were stored and the new address is 
displayed on the next line. 


"=", A minus sign does not store a 
byte. The address will be decremented 
to the previous address. The minus 
sign can be used to "back up" to a 
previous location in case an error has 
been made. 


(CR) only. If no entry is made on the 
line, the memory byte remains 
unchanged. The address is incremented 
by 1 and displayed on the next line. 


period. A period ends the input mode 
and returns to the command level. 


In the example that follows, assume that the 


"@" register 


-SM@1008 


contains the value 2896H. 
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2926 8100° 32 @ 

2981 6101' 17 60 

2902 @162' 31 ‘THIS IS AN ASCII STRING' 
2919 @119° 7A 'AAAA' 8 B12345678 9 
2928 @128' 22 

2929 8129' 29 

292A B1l2A' 87 - 

2929 @129' 29. 


Sr - SUBSTITUTE REGISTER 


The Sr tommand allows the user registers to be 
altered. The letter "r“ stands for the register 
which is to be changed. The section SUMMARY OF 
REGISTER NAMES gives a summary of the names that 
can be substituted. When substituting the F and F' 
flags, enter the command SF or SF'. DEBUG will 
then print the flags that are set and wait for the 
operator to enter the names of the registers that 
are to be set. If the flags are NOT entered, the 
flags are reset. In the following example, the 
“SZHC" flacs are set. After the example is 
executed the "ZC" flags are set. The lower case 
letters are entered by the operator. 


-sf 
S2H C 2¢ 


When sustituting a one byte register, a one 
byte value is accepted. When substituting a two 
byte register, a two byte value is accepted. If no 
value is entered, or if an error occurs, the value 
of the register remains unchanged. In the 
following example, the A register is changed to 
contain 41H. 


-sa 
A=9B8 41 
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T - TRACE 
The format of trace is: 


T (CR) 
T number-of-lines (CR) 


The first format traces the program through one 
instruction. The second format traces the program 
through "number-of-lines" instructions. After 
every instruction traced, the values of the user 
registers are printed in the same format as the 
"DR" command. 


You can trace only through RAM. The trace 
command places a break point after the instruction, 
loads the registers and executes the instruction. 
The break point is then executed and the registers 
are resaved. The registers are printed, and the 
next instruction is executed unless the count has 
reached zero, in which case a prompt is printed and 
you may enter the next command. 


To abort the trace, hit any key on the 
console. A prompt will be printed and you may 
enter the next command. 


TN ~ TRACE WITH NO PRINTING 


The "TN" command is the same as the "T" 
command with the exception that after every 
instruction is traced, the registers are not 
printed. Only the last traced instruction is 
printed. 


V ~ VERIFY MEMORY 


Verify that the block of memory between souce 
address and source end contain the same value as 
the block beginning at destination address. The 
addresses and contents are printed for each 
discrepancy found. The following is the format of 
this command. 


V Source-addr source-end destination-addr 
V source-addr S swath-width destination-addr 
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This command works by reading bytes from the source 
and destination and comparing them, If a 
Giscrepancy is found, the memory is read again for 
print-out. Thus, it can happen that a discrepancy 
is printed-out with the source and the destination 
contents indicated to be the same. This is caused 
by a defective memory element. 


A discrepancy is printed in the following 
order, source address, source contents, destination 
contents, destination address. In the example that 
follows, memory locations 1603ii and 1988H are 
defective. 


-V S38 1602 
8683 32 12 1883 
@808 7A 5A 1088 
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